Versi 1
| Field | Isi |
|---|---|
| Dokumen ID | VBS-SYS-001 |
| Deskripsi | Pengaturan metode pembayaran brand: daftar, pencarian, tambah, lihat, ubah, hapus ke arsip, dan pemulihan metode pembayaran beserta akun kas atau bank dan cabang yang memakainya |
| Nomor Revisi | 1 |
| Tanggal | 2026-10-04 |
| Keterangan | Dokumentasi baseline dari dokumentasi fitur demo dan kode FE |
1. Ringkasan
a. In scope
- User dapat melihat daftar metode pembayaran dengan kolom nama pembayaran, jenis metode pembayaran, dan akun metode pembayaran.
- User dapat mencari metode pembayaran berdasarkan nama pembayaran.
- User dapat menambah metode pembayaran dengan nama, jenis (Tunai, EDC, E-Wallet, Transfer), akun kas atau bank, dan cabang yang boleh memakai (satu, beberapa, atau semua cabang).
- User dapat melihat detail metode pembayaran beserta daftar cabang yang memakainya.
- User dapat mengubah metode pembayaran termasuk menambah atau mengurangi cabang.
- User dapat menghapus metode pembayaran sehingga masuk arsip, lalu memulihkannya kembali dari halaman arsip.
- Vobis menyediakan metode pembayaran default yang umum dipakai usaha.
b. Catatan
c. Kesimpulan
- [FE] -
- [BE] -
2. Functional Requirement
| Kode | Deskripsi |
|---|---|
| FR-01 | Sistem menampilkan daftar metode pembayaran aktif dengan infinite scroll |
| FR-02 | Sistem menyediakan pencarian berdasarkan nama pembayaran dan menyimpan kata kunci di URL |
| FR-03 | User dapat menambah metode pembayaran dengan nama, jenis, akun, dan cabang |
| FR-04 | User dapat melihat detail metode pembayaran dan cabang pemakainya |
| FR-05 | User dapat mengubah metode pembayaran dan relasi cabangnya |
| FR-06 | User dapat menghapus metode pembayaran ke arsip |
| FR-07 | User dapat memulihkan satu atau banyak metode pembayaran dari arsip |
| FR-08 | Sistem membatasi aksi sesuai hak akses lihat, ubah, dan arsip |
3. Use Case List
| Kode | Deskripsi |
|---|---|
| UC-01 | Melihat daftar metode pembayaran |
| UC-02 | Mencari metode pembayaran berdasarkan nama |
| UC-03 | Menambah metode pembayaran |
| UC-04 | Melihat detail metode pembayaran |
| UC-05 | Mengubah metode pembayaran |
| UC-06 | Menghapus metode pembayaran ke arsip |
| UC-07 | Memulihkan metode pembayaran dari arsip |
4. Use Case Scenario
UC-01 : Melihat daftar metode pembayaran
| Aktor | User brand |
| Deskripsi | User melihat metode pembayaran yang tersedia di brand |
| Prekondisi | User memiliki akses menu Metode Pembayaran |
| Alur utama | 1. User membuka menu Pengaturan lalu Metode Pembayaran. 2. Sistem memuat daftar metode pembayaran halaman pertama. 3. Sistem menampilkan nama pembayaran, jenis metode pembayaran, dan akun metode pembayaran. 4. User menggulir untuk memuat halaman berikutnya. |
| Alur negatif | - Jika gagal memuat, daftar kosong dengan teks "Metode Pembayaran is Empty". - Jika user tidak punya akses menu, muncul notifikasi tidak memiliki akses menu. |
| Bisnis rule | - Jumlah per halaman 10 data. - Akun metode pembayaran ditampilkan dari rekening terkait. |
| Postkondisi | Daftar metode pembayaran tampil |
| Trigger | User membuka halaman Metode Pembayaran |
| Kode FR | FR-01 FR-08 |
UC-02 : Mencari metode pembayaran berdasarkan nama
| Aktor | User brand |
| Deskripsi | User menyaring daftar dengan nama pembayaran |
| Prekondisi | User berada di daftar metode pembayaran |
| Alur utama | 1. User mengetik kata kunci di kolom "Cari Nama Pembayaran". 2. Sistem kembali ke halaman pertama dan memuat ulang daftar sesuai kata kunci. 3. Sistem menyimpan kata kunci di URL. |
| Alur negatif | - Jika tidak ada data yang cocok, daftar kosong. |
| Bisnis rule | - Jika halaman dibuka dengan query nama_pembayaran, kata kunci langsung terisi. |
| Postkondisi | Daftar tersaring |
| Trigger | User mengetik kata kunci |
| Kode FR | FR-02 |
UC-03 : Menambah metode pembayaran
| Aktor | User brand dengan akses ubah |
| Deskripsi | User membuat metode pembayaran baru di luar yang disediakan Vobis |
| Prekondisi | User berada di daftar metode pembayaran |
| Alur utama | 1. User menekan Tambahkan Baru. 2. User mengisi nama metode pembayaran. 3. User memilih jenis metode pembayaran. 4. User memilih akun metode pembayaran. 5. User memilih satu atau beberapa cabang, atau membiarkan kosong untuk semua cabang. 6. User menyimpan. 7. Sistem menyimpan, kembali ke daftar, dan menampilkan "Berhasil buat Metode Pembayaran". |
| Alur negatif | - Jika nama, jenis, atau akun kosong, muncul "Form harus diisi!". - Jika server menolak, muncul notifikasi error dari server. |
| Bisnis rule | - Jenis metode pembayaran: Tunai, EDC, E-Wallet, Transfer. - Akun yang bisa dipilih hanya rekening kelompok nomor 11, 12, 18, 19, 21, dan 23. - Jika cabang kosong, metode berlaku untuk semua cabang ( gudang = all).- Jika tepat satu cabang dipilih, metode ditandai untuk satu gudang. |
| Postkondisi | Metode pembayaran baru tersedia |
| Trigger | User menekan Simpan di form tambah |
| Kode FR | FR-03 |
UC-04 : Melihat detail metode pembayaran
| Aktor | User brand dengan akses lihat |
| Deskripsi | User melihat rincian satu metode pembayaran |
| Prekondisi | User berada di daftar metode pembayaran |
| Alur utama | 1. User mengklik satu kali baris metode pembayaran. 2. Sistem membuka halaman lihat. 3. Sistem menampilkan nama, jenis, akun, dan daftar cabang pemakai. |
| Alur negatif | - Jika user tidak punya akses lihat, klik tidak membuka halaman. - Jika user tidak punya akses ke gudang tertentu, nama gudang tampil "Anda tidak memiliki akses untuk melihat nama gudang ini". |
| Bisnis rule | - Jika tidak ada relasi cabang, ditampilkan "Berlaku untuk semua cabang". |
| Postkondisi | Detail metode pembayaran tampil |
| Trigger | User klik satu kali pada baris |
| Kode FR | FR-04 FR-08 |
UC-05 : Mengubah metode pembayaran
| Aktor | User brand dengan akses ubah |
| Deskripsi | User memperbarui data dan cabang metode pembayaran |
| Prekondisi | Metode pembayaran sudah ada |
| Alur utama | 1. User mengklik dua kali baris metode pembayaran. 2. Sistem membuka form ubah berisi data saat ini. 3. User mengubah nama, jenis, akun, atau cabang. 4. User menyimpan. 5. Sistem menyimpan dan menampilkan "Berhasil update Metode Pembayaran". |
| Alur negatif | - Jika user tidak punya akses ubah, klik dua kali tidak membuka form. - Jika nama, jenis, atau akun kosong, muncul "Form harus diisi!". - Jika server menolak, muncul notifikasi error. |
| Bisnis rule | - Cabang lama yang tidak dipilih lagi dikirim dengan tanda hapus. - Cabang baru dikirim sebagai relasi baru. - Jika cabang dikosongkan, metode berlaku untuk semua cabang dan relasi cabang dihapus oleh server. |
| Postkondisi | Metode pembayaran terbarui |
| Trigger | User menekan Simpan di form ubah |
| Kode FR | FR-05 FR-08 |
UC-06 : Menghapus metode pembayaran ke arsip
| Aktor | User brand dengan akses ubah |
| Deskripsi | User menghapus metode pembayaran yang tidak dipakai |
| Prekondisi | Metode pembayaran ada di daftar |
| Alur utama | 1. User menekan ikon hapus di baris. 2. Sistem menampilkan konfirmasi "Anda yakin ingin menghapus Metode Pembayaran ...?". 3. User mengonfirmasi. 4. Sistem menghapus, menampilkan "Berhasil hapus Metode Pembayaran", dan menghilangkan baris dari daftar. |
| Alur negatif | - Jika user membatalkan, data tidak dihapus. - Jika server menolak, muncul notifikasi error dari server. |
| Bisnis rule | - Ikon hapus hanya tampil untuk user dengan akses ubah (basic). - Metode pembayaran nonaktif tampil di halaman arsip. |
| Postkondisi | Metode pembayaran tidak tampil di daftar aktif |
| Trigger | User mengonfirmasi hapus |
| Kode FR | FR-06 FR-08 |
UC-07 : Memulihkan metode pembayaran dari arsip
| Aktor | User brand dengan akses arsip |
| Deskripsi | User mengaktifkan kembali metode pembayaran yang diarsipkan |
| Prekondisi | Ada metode pembayaran nonaktif |
| Alur utama | 1. User menekan tombol Arsip di daftar. 2. Sistem menampilkan semua metode pembayaran nonaktif. 3. User mencentang satu atau beberapa data. 4. User memilih pulihkan dan mengonfirmasi. 5. Sistem mengaktifkan kembali data terpilih dan menampilkan "Berhasil memulihkan Metode Pembayaran terpilih". |
| Alur negatif | - Tombol Arsip tidak tampil jika user tidak punya akses arsip. - Jika user membatalkan konfirmasi, data tidak dipulihkan. - Jika server menolak, muncul notifikasi error. |
| Bisnis rule | - Daftar arsip dimuat tanpa pagination. - Pemulihan dilakukan sekaligus untuk semua data terpilih. |
| Postkondisi | Metode pembayaran kembali aktif |
| Trigger | User mengonfirmasi pulihkan |
| Kode FR | FR-07 FR-08 |
5. Data Flow Diagram
DFD-01
6. Sequence Diagram
SD-01 — UC-01 : Melihat daftar metode pembayaran
SD-02 — UC-02 : Mencari metode pembayaran berdasarkan nama
SD-03 — UC-03 : Menambah metode pembayaran
SD-04 — UC-04 : Melihat detail metode pembayaran
SD-05 — UC-05 : Mengubah metode pembayaran
SD-06 — UC-06 : Menghapus metode pembayaran ke arsip
SD-07 — UC-07 : Memulihkan metode pembayaran dari arsip
7. Table Schema
8. API Schema
| Endpoint | Status | Perubahan |
|---|---|---|
GET /metode-pembayaran | existing | - |
GET /metode-pembayaran/:id | existing | - |
POST /metode-pembayaran | existing | - |
PUT /metode-pembayaran/:id | existing | - |
DELETE /metode-pembayaran/:id | existing | - |
POST /metode-pembayaran/bulk-update | existing | - |
GET /rekening | existing | - |